---
title: Usa bun con Astro
description: Impara come usare Bun con il tuo sito Astro.
type: recipe
i18nReady: true
---

[Bun](https://bun.sh/) è un runtime e toolkit JavaScript all-in-one. Per maggiori informazioni, consulta [la documentazione di Bun](https://bun.sh/docs).

:::caution
Bun ha rilasciato da poco la sua prima versione stabile. Tuttavia, l'utilizzo di Bun con Astro potrebbe rivelare qualche problema. Alcune integrazioni potrebbero non funzionare come previsto. Consulta [la documentazione ufficiale di Bun per lavorare con Astro](https://bun.sh/guides/ecosystem/astro) per maggiori dettagli.

Se hai riscontri alcuni problemi usando Bun, perfavore [apri una Issue su GitHub con Bun direttamente](https://github.com/oven-sh/bun/issues/new/choose).
:::

## Prerequisiti

- Bun installato localmente sulla tua macchina. Consulta [le istruzioni di installazione](https://bun.sh/docs/installation) nella documentazione ufficiale di Bun.

## Crea un nuovo progetto Astro con Bun

Crea un nuovo progetto Astro con Bun usando il seguente comando `create-astro`:

```bash
bunx create-astro@latest my-astro-project-using-bun
```

:::tip
Puoi creare anche un [nuovo progetto Astro da qualsiasi repository Astro GitHub esistente](/it/install/auto/#template-di-partenza) usando il flag `--template`:
```bash
bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal
```
:::

## Installare le dipendenze

Se stai avviando un nuovo progetto usando `bunx create-astro`, la CLI utilizzerà automaticamente Bun per installare le dipendenze e puoi saltare questo passaggio.

Altrimenti, dovrai installare le dipendenze con Bun:

```bash
bun install
```

## Aggiungere i Types

Bun pubblica i tipi di runtime per Bun nel pacchetto [`@types/bun`](https://www.npmjs.com/package/@types/bun).

Installa `@types/bun` usando il seguente comando:

```sh
bun add -d @types/bun
```

## Usare le integrazioni di Astro

Potresti anche usare qualsiasi integrazione ufficiale di Astro con il comando `astro add`:

```bash
bunx astro add react
```

## Esegui Astro con Bun

:::note
Usa il flag CLI [`--bun`](https://bun.sh/docs/cli/bunx#shebangs) prima di ogni comando `astro` per usare il runtime di Bun al posto di Node.
:::

### Esegui il server di sviluppo

Per eseguire il server di sviluppo usando Bun come runtime, usa il seguente comando:

```bash
bunx --bun astro dev
```

### Crea il tuo sito con Bun

Per creare il tuo sito usando Bun come runtime, usa il seguente comando:

```bash
bunx --bun astro build
```

Astro scriverà l'output del tuo sito nella cartella `dist/`. Puoi servire il tuo sito usando il comando `preview`: 

```bash
bunx --bun astro preview
```

## Aggiungere l'SSR con Bun

Poiché Bun supporta la [compatibilità con le API di Node.js](https://bun.sh/docs/runtime/nodejs-apis), puoi usare qualsiasi adattatore Astro per [il rendering lato server](/it/guides/server-side-rendering/) al tuo progetto Astro:

```bash
bunx astro add vercel
```

## Testare con Bun

Bun è fornito con un test runner integrato, veloce e compatibile con Jest, tramite il comando `bun test`. Se vuoi usarlo, leggi la documentazione di [`bun test`](https://bun.sh/docs/cli/test).

Comunque, è anche possibile usare Cypress o Playwright per un approccio moderno al testing delle web app.

### Cypress

Cypress è un tool di testing front-end e ha come obiettivo "rendere l'esperienza di testing piacevole e generare felicità per gli sviluppatori". Questo ti permette di scrivere test end-to-end per il tuo sito Astro.

Installa Cypress con il seguente comando:

```bash
bun add cypress --dev
```

Per il resto della configurazione e per iniziare il tuo primo test, segui il resto del processo di Cypress nella [Guida al Testing di Astro](/it/guides/testing/#configuration).

### Playwright

Playwright è un framework di testing end-to-end che ti permette di testare il tuo codice Astro su tutti i moderni motori di rendering, inclusi Chromium, WebKit e Firefox.

Installa Playwright con il seguente comando:

```bash
bun create playwright
```

Per creare il tuo primo test di Playwright, segui le istruzioni per il resto del processo di Playwright nella [Guida al Testing di Astro](/it/guides/testing/#create-your-first-playwright-test).

## Risorse Ufficiali

- [Crea un app con Astro e Bun](https://bun.sh/guides/ecosystem/astro)

## Risorse della Community

Usi Bun con Astro? Aggiungi il tuo blog post o video a questa pagina!

- [Crea un sito con Cloudflare Pages usando Bun](https://blog.otterlord.dev/posts/hello-from-bun/) - blog post
